home *** CD-ROM | disk | FTP | other *** search
/ IRIX Base Documentation 2001 May / SGI IRIX Base Documentation 2001 May.iso / usr / share / catman / u_man / cat1 / ident.z / ident
Encoding:
Text File  |  1998-10-20  |  7.4 KB  |  199 lines
  1.  
  2.  
  3.  
  4. IIIIDDDDEEEENNNNTTTT((((1111))))                                                              IIIIDDDDEEEENNNNTTTT((((1111))))
  5.  
  6.  
  7.  
  8. NNNNAAAAMMMMEEEE
  9.      ident - identify RCS keyword strings in files
  10.  
  11. SSSSYYYYNNNNOOOOPPPPSSSSIIIISSSS
  12.      iiiiddddeeeennnntttt [ ----qqqq ] [ ----VVVV ] [ _f_i_l_e ... ]
  13.  
  14. DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
  15.      iiiiddddeeeennnntttt searches for all instances of the pattern $$$$_k_e_y_w_o_r_d:::: _t_e_x_t $$$$ in the
  16.      named files or, if no files are named, the standard input.
  17.  
  18.      These patterns are normally inserted automatically by the RCS command
  19.      ccccoooo(1), but can also be inserted manually.  The option ----qqqq suppresses the
  20.      warning given if there are no patterns in a file.  The option ----VVVV prints
  21.      iiiiddddeeeennnntttt's version number.
  22.  
  23.      iiiiddddeeeennnntttt works on text files as well as object files and dumps.  For
  24.      example, if the C program in ffff....cccc contains
  25.  
  26.           ####iiiinnnncccclllluuuuddddeeee <<<<ssssttttddddiiiioooo....hhhh>>>>
  27.           ssssttttaaaattttiiiicccc cccchhhhaaaarrrr ccccoooonnnnsssstttt rrrrccccssssiiiidddd[[[[]]]] ====
  28.             """"$$$$IIIIdddd:::: ffff....cccc,,,,vvvv 1111....11111111 1111999999998888////00001111////11112222 22223333::::33331111::::11117777 ppppjjjj EEEExxxxpppp $$$$"""";;;;
  29.           iiiinnnntttt mmmmaaaaiiiinnnn(((()))) {{{{ rrrreeeettttuuuurrrrnnnn pppprrrriiiinnnnttttffff((((""""%%%%ssss\\\\nnnn"""",,,, rrrrccccssssiiiidddd)))) ======== EEEEOOOOFFFF;;;; }}}}
  30.  
  31.      and ffff....cccc is compiled into ffff....oooo, then the command
  32.  
  33.           iiiiddddeeeennnntttt  ffff....cccc  ffff....oooo
  34.  
  35.      will output
  36.  
  37.           ffff....cccc::::
  38.               $$$$IIIIdddd:::: ffff....cccc,,,,vvvv 1111....11111111 1111999999998888////00001111////11112222 22223333::::33331111::::11117777 ppppjjjj EEEExxxxpppp $$$$
  39.           ffff....oooo::::
  40.               $$$$IIIIdddd:::: ffff....cccc,,,,vvvv 1111....11111111 1111999999998888////00001111////11112222 22223333::::33331111::::11117777 ppppjjjj EEEExxxxpppp $$$$
  41.  
  42.      If a C program defines a string like rrrrccccssssiiiidddd above but does not use it,
  43.      lllliiiinnnntttt(1) may complain, and some C compilers will optimize away the string.
  44.      The most reliable solution is to have the program use the rrrrccccssssiiiidddd string,
  45.      as shown in the example above.
  46.  
  47.      iiiiddddeeeennnntttt finds all instances of the $$$$_k_e_y_w_o_r_d:::: _t_e_x_t $$$$ pattern, even if
  48.      _k_e_y_w_o_r_d is not actually an RCS-supported keyword.  This gives you
  49.      information about nonstandard keywords like $$$$XXXXCCCCoooonnnnssssoooorrrrttttiiiiuuuummmm$$$$.
  50.  
  51. KKKKEEEEYYYYWWWWOOOORRRRDDDDSSSS
  52.      Here is the list of keywords currently maintained by ccccoooo(1).  All times
  53.      are given in Coordinated Universal Time (UTC, sometimes called GMT) by
  54.      default, but if the files were checked out with ccccoooo's ----zzzz_z_o_n_e option, times
  55.      are given with a numeric time zone indication appended.
  56.  
  57.      $$$$AAAAuuuutttthhhhoooorrrr$$$$
  58.           The login name of the user who checked in the revision.
  59.  
  60.  
  61.  
  62.  
  63.                                                                         PPPPaaaaggggeeee 1111
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70. IIIIDDDDEEEENNNNTTTT((((1111))))                                                              IIIIDDDDEEEENNNNTTTT((((1111))))
  71.  
  72.  
  73.  
  74.      $$$$DDDDaaaatttteeee$$$$
  75.           The date and time the revision was checked in.
  76.  
  77.      $$$$HHHHeeeeaaaaddddeeeerrrr$$$$
  78.           A standard header containing the full pathname of the RCS file, the
  79.           revision number, the date and time, the author, the state, and the
  80.           locker (if locked).
  81.  
  82.      $$$$IIIIdddd$$$$ Same as $$$$HHHHeeeeaaaaddddeeeerrrr$$$$, except that the RCS filename is without a path.
  83.  
  84.      $$$$LLLLoooocccckkkkeeeerrrr$$$$
  85.           The login name of the user who locked the revision (empty if not
  86.           locked).
  87.  
  88.      $$$$LLLLoooogggg$$$$
  89.           The log message supplied during checkin.  For iiiiddddeeeennnntttt's purposes, this
  90.           is equivalent to $$$$RRRRCCCCSSSSffffiiiilllleeee$$$$.
  91.  
  92.      $$$$NNNNaaaammmmeeee$$$$
  93.           The symbolic name used to check out the revision, if any.
  94.  
  95.      $$$$RRRRCCCCSSSSffffiiiilllleeee$$$$
  96.           The name of the RCS file without a path.
  97.  
  98.      $$$$RRRReeeevvvviiiissssiiiioooonnnn$$$$
  99.           The revision number assigned to the revision.
  100.  
  101.      $$$$SSSSoooouuuurrrrcccceeee$$$$
  102.           The full pathname of the RCS file.
  103.  
  104.      $$$$SSSSttttaaaatttteeee$$$$
  105.           The state assigned to the revision with the ----ssss option of rrrrccccssss(1) or
  106.           cccciiii(1).
  107.  
  108.      ccccoooo(1) represents the following characters in keyword values by escape
  109.      sequences to keep keyword strings well-formed.
  110.  
  111.           _c_h_a_r     _e_s_c_a_p_e _s_e_q_u_e_n_c_e
  112.           tab      \\\\tttt
  113.           newline  \\\\nnnn
  114.           space    \\\\000044440000
  115.           $$$$        \\\\000044444444
  116.           \\\\        \\\\\\\\
  117.  
  118. IIIIDDDDEEEENNNNTTTTIIIIFFFFIIIICCCCAAAATTTTIIIIOOOONNNN
  119.      Author: Walter F. Tichy.
  120.      Revision Number: 5.7; Release Date: 1998/01/12.
  121.      Copyright c 1982, 1988, 1989 by Walter F. Tichy.
  122.      Copyright c 1990, 1992, 1993 by Paul Eggert.
  123.  
  124.  
  125.  
  126.  
  127.  
  128.  
  129.                                                                         PPPPaaaaggggeeee 2222
  130.  
  131.  
  132.  
  133.  
  134.  
  135.  
  136. IIIIDDDDEEEENNNNTTTT((((1111))))                                                              IIIIDDDDEEEENNNNTTTT((((1111))))
  137.  
  138.  
  139.  
  140. SSSSEEEEEEEE AAAALLLLSSSSOOOO
  141.      ci(1), co(1), rcs(1), rcsdiff(1), rcsintro(1), rcsmerge(1), rlog(1),
  142.      rcsfile(4), RCSsource(5)
  143.      Walter F. Tichy, RCS--A System for Version Control, _S_o_f_t_w_a_r_e--_P_r_a_c_t_i_c_e &
  144.      _E_x_p_e_r_i_e_n_c_e 11115555, 7 (July 1985), 637-654.
  145.  
  146.  
  147.  
  148.  
  149.  
  150.  
  151.  
  152.  
  153.  
  154.  
  155.  
  156.  
  157.  
  158.  
  159.  
  160.  
  161.  
  162.  
  163.  
  164.  
  165.  
  166.  
  167.  
  168.  
  169.  
  170.  
  171.  
  172.  
  173.  
  174.  
  175.  
  176.  
  177.  
  178.  
  179.  
  180.  
  181.  
  182.  
  183.  
  184.  
  185.  
  186.  
  187.  
  188.  
  189.  
  190.  
  191.  
  192.  
  193.  
  194.  
  195.                                                                         PPPPaaaaggggeeee 3333
  196.  
  197.  
  198.  
  199.